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8. HUMAN INTERFACE 

9. START UP SYSTEM 




BASIC 


CHAPTER 1 

l /o SYSTEM REVIEW 



THE FILE 


• A COLLECTION OF DATA 

• ORGANIZED AT BYTE LEVEL 

• MEDIA INDEPENDANt(ATFIUE LEVEL) 


1 - 2 . 



THE FILE 

A COLLECTION OF DATA 

•DATA FROM PROCESS CONTROL. 

• text (letter, Report, etc.) 

•INFORMATION PASSED FRorA 
TASK TO TASK 

• Reference information 

(inventory, PAYROLL, ETC.) 



FHE FILE 


• ORGANIZED AT BYTE LEVEL 

•LEN6TH 

•POINTER 



*EEK« 


REAP 


■>5EEK 

■►WRITE 


Pointer 


length 
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THE FILE 

• MLDIA INDEPENDENT {AT FILE- LEVEL) 

•DESIGN FLEXIBILITY 
•TEST FLEXIBILITY 
•RUN TIME FLEXIBILITY 


1-5 



ACCESS METHODS 

• Sequential access 

I 

• RANDOM ACCESS 

1-6 


RMX-86 file types 


PHYSICAL 

NAMED 


STREAM 



Note.: pevice must support random access. 


I 




50ME EXAMPLE^ 


$EQUENT/AL/PHYS1CAL 

— THE TELETYPE 


THE LINEPRINTER . ETC. 

randoia /named 

- RMX Disk OR DISKETTE 


OR BUBBLE 

sequential / streaw 

- INTERTASK DATA TRANSFER 

RAN DOW /PHYSICAL --v 
OR > 

SEQUENTIAL/ PHYSICAL j 

READ OR V/RlTE ANY FORMAT 
DISKETTE OR TAPE 

1 
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\AJ > JO .fl^O ?o-o pom\Ac 


RMX-86 Vo SYSTEM 



K 


STREW 

FILE 

DRIVER 



MO 




THE. FILE DRIVER 


USER % REQUEST 

Reap, write, seek, etc. 


T /o Resuit 4 
SEGMENT 



* T /o REQUEST 


% RESULT 
SEG MENTIS) 


USER PROGRAM 4 


► DEVICE DRIVER 





IVER 


DEVICE COMMAND* 


.DATA F^OtA^TO 
DEVICE 


DEVICE 


l-IZ 




BtelC Vo SYSTEM 

'"most intimate form of Vo system inter action 

ADVANTAGES 

# ASYNCHRONOUS C ALLOWS OVERlAPPEP Vo and 
USE.R PROCESSING?') 

# Most compact version of Vo oVstem. 

Disadvantage 

# FAIRLY COrnPuiCATED USER interface 


/-/V 



BASIC r /o SYSTEM 

INTERACTION EXAMPLE 

f 

/■*■ NOW START I/O PROCESSING •* / 

CALL R<3 A READ^ , , © RESP MBX , @ STATUS); 

/* test Result of call itself */ 

IF ^STATUS < > 0) THEN 

/* bad call*/ 
bao_call: do; 

/* HANDLE PROBLEM WITH CALL*/ 

END 6ad_call; 

EL^E- 

/#- O. K. so FAR ■*•/ 

Good__call: Do; 


/-/S' 



BASIC z /o 6Y6iEM 

INTERACTION EXAMPLE {CONTINUED) 


/ * DO CONCURRENT PROCESSING */ 

/* NOW GET response from Vo sTstem •*/ 
MSGTKN = RQ RECEIVE MESSAGE (RESPMBX, a , ©STATUS): 
/* CHECK. CALL */ 

IF ('STATUS < ><25) THEN 
/#• BAD SYSTEM CALL HANDLED HERE.*/ 

ELSE 

/# WE CAN PROCEED*/ 
o»o_ on : do- 

Msg ptr = Pointer i^e £msgtkn); 


H 0 



BtalC V© 5 V STEM 

INTERACTION EXAMPLE CcontinvEO) 


/ * CHECK STATUS FIELD Vo RESULT 5 ECaM ENT */ 

IF (M S6. STATUS < > 0) THEN 

/* BAD Vo, HANDLE IT AND DELETE TORS */ 

ELSE 

/* FInM-lV Process data in the Buffer */ 



EXTENDED Vo SYSTEM 

"TH£ l/S £R FRlENOL Y z /c tNTZRFALF* 

ADVANTAGES 

•SIMPLE INTEFACE- SIN 6LE CALL. 

• AUTOMATIC BUFFERING- READ AHEAD, 

WRITE BEHIND 

disadvantages 

• MORE MEMORY REQUIRED ^ABov'E BASIC s /o SYSTEM) 


•NOT EFFICIENT FOR RANDOM ACCESS 



EXTENDED r /o SYSTEM 

I NTER ACTION EX M^PLE 

/* READ DISK FILE AND PLACE DATA IN BUFF*/ 

NU MBYTES = RQS READ MOVE ( , 8UFF PTR, BYTES REQ, @ STATUS^; 

/* CHECK STATUS*/ 

XF /STATUS < > <# ) THEN 

/# PROCESS ERROR*/ 

ELSE 

A PROCESS DATA */ 






VJHY USE THE BfcSK. z /o SYSTEM? 


• I NEED EXTREME FLEXIBILITY 

• X NEED EFFICIENT PAN DOM ACCESS 

• I MUST CONSERVE MEMORV 

• I WANT TO OVERLAP MV PROCESSING 
WITH I/O PROCESSING* 

• i'm masochistic 

/' 5 / 




VIHV USE the EXTENDED T/o system ? 


I LIKE THE EASY INTERFACE 
I CAN AFFORD THE MEMORY 

iVl PRIMARILY USING SEQUENTIAL ACCESS 

so automatic buffering helps thru put 

t DO NOT NEED OVERLAPPED x /o AND 
USER processing 



CHAPTER QUIZ 


1. What are the three attributes of a file ? 



X WHAT ARE THE THREE RKX-86 FILE TYPES? 


3. CAN I TREAT A STREAM FILE DRIVER IN A RANDOM 

ACCESS MANNER? 

4. WHAT COMBINATION OF FILE TYPE AND ACCESS METHOD 

WOULD I USE TO READ AN ISIS FORMAT DISKETTE? 
AND 
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CHAPTER OU\Z Ccont') 


5. WHAT KIND OP INFORMATION RASSES BETWEEN THE 
FILE DRIVER AND THE DEVICE DRIVER? 


6. List an advantage of the basic */© system. 


7. LIST AN ADVANTAGE OF THE EXTENDED */© SYSTEM. 


CHAPTER x. 


basic r / 0 
. SYSTEM 

configuration 



BASIC Vo SYSTEM CON F 16 U RATION 


• SELECT FEATURES DESIRED 

Cl TABLE. ABO 

• DESCRIBE THE I/O DEVICES 

CIDEVCF. ABC) 



X TABLE . ASfe 





I TABi-E . AS© 

SYSTEM CALL SELECTION 
NON-FILE INTERFACE 


• PARAMETER INTERFACE 

LOCAL PARAMETERS 

• CONFIGURATION INTERFACE 

ATTACH - DETACH 

• POWER-FAIL INTERFACE 

POWER-UP, POWER-DOWN 

• DATE/TIME INTERFACE 

DATE AND Time INFORMATION 



ITABLE.A86 

FILE. DRIVER GLOBAL DATA 


• NUMBER OF FILE DRIVERS 


• Attach device priority 


• TIMER TASR PRIORITY 



I TABLE , A8fc 
FILE DRIVER TABLES 


• DO MOT TOUCH \ 




I TABLE. 

OPTIONAL FEATURE SELECTION 

• DUMMY-TIMER 

• no_create_fm.se 

• K|0_ TRUNCATE 


• no -Allocate 



X DEV CF. *86 
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IDEVCF. *86 

DEVICE- UNIT INFORMATION BLOCK* 

COHPONtNTS 

• DEVICE NAME CVP TO 14- CHARACTERS') 

• file DRIVERS Csupported) 

• FUNCTIONS CsuPPORTE.D') 

• FLACjS ([diskettes only, typeof drive) 

• DEVICE GRANULARITY ( RANDOM ACCESS USUALLY) 

• low /high sac Cdevice storage capacity) 

• DEVICE NUMBER CPER DEVICE (on controller)) 
•UNIT NUMBER C PER UNIT ON A GIVEN DEVICE) 



I PEVCF. A8& 

DEVICE-UNIT INFORMATION BLOCKS 


PEVICE-UNIT NUMBER 

I NIT- 10 
FINISH-XO 

QVEQE-TO 

CANCEL -XO 

DEVICE- INFO 

UNIT- INFO 


(UNIQUE IN THE SYSTEM') 
(INITIALISE t/d dev ice driver) 

(FINISH I/o DEVICE DRIVER) 
(QUEUE I/o DEVICE DRIVER") 
(CANCEL r /b DEVICE DRIVER) 
(ADDRESS OP DEVICE INFO. BLOCK) 
(ADDRESS OF UNIT INFO. BLOCK) 


UPOATE-TI MEOUT (FREQUENCY OF UPDATE) 


NUM-8UFFERS 

PRIORITY 


(NUMBER OF BUFFERS FOR RANDOM 
ACCESS DEVICES') 

(SERVICE TASK PRIORITY") 
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DEVICE. INFORMATION TABLES 

•COMMON OR RANDOM DEVICE. TA&LE- 


• LEVEL 

(interrupt LEVEL) 

• priority 

(.DEVICE INTERRUPT TASK) 

• 5TACK-SI2.E 

(user written interrupt procedure) 

• DATA -SIZE 

(user Portion of device data object) 

• NUM_ UNITS 

(NUMBER OF UNITS SUPPORTED) 

• DEVICE- IN IT 

(.USER WRITTEN DEVICE INITIALIZATION) 

• DEVICE-FINISH 

( M '» " finish) 

• DEV ICE -START 

C " " " st art) 

• DEVICE .STOP 

( “ " " stop) 

• DEVICE- INTERRUPT 

C “ " M interrupt) 


X-IX 



UNIT INFORMATION TABLES 


• NORMALLY RANDOM ONLY 

RANDOM- UN IT- INFO 

• TRACK. 5 IZ.E (one track , 0 i F contRou-er 

CAN CROSS TRACK BOUNDARIES} 




MAX- RETRY 


C NUMBER OF ATTEMPS") 



X DEV CF . A86 

6ENERAW DEVICE INFORMATION 

DEVICE-TABLES 


• TOTAL NUMBER OP D.U.XJB.'s 


• number op device units defined 


• NUMBER OF DEVICES DEFINED 





ASSEMBLING, UNKING AND LOCATING THE BASIC 
I Vo SYSTEM 


• MODIFY rTABLE.ABfc AND T DEVCF . A^b 
TO YOuR TASTES 

• SET UP SUBMIT FILE TO MATCH YOUR 
DEVELOPEMENT RESOURCES 

• SUBMIT :fx*. IOS(date,loc_adr') 



CHAPTER QlMZ- 


1. T-P X CAN MODIFY THE PILE ORIWERTABLES . 

X. WHICH FILE CONTAINS THE DUMMV TIMER? 

3. WHAT ARE THE 5. TABLES FOR A RANDOM DRIVER? 

A B. C. 

4. IN WHICH FILE OO VOU FINO THE ADORESS OF THE 
OEVICE START PROCEDURE? 


A-l 5 


CHAPTER QUIZ 

( continued - ) 


5 . IF I HAD 3 CS6C *04 CARDS AND 1 ISBC CARD 
IN ADDITION TO THE TERMINAL IN A SYSTEMS, HOW 
MANY DEVICE} WOULD I HAVE? 


6. EACH DISK INTERFACE CARD HAS X DRIVES ASSOCIATED 
WITH IT. HOW MANY DEVICE* ON IT NUMBERS WOOiD 
I HAVE? 



CHAPTER 3 


THE BOOTSTRAP LOADER 



WHAT IS IT? 


THE BOOTSTRAP LOADER IS A PROGRAM 
VJHICH ALLOWS AN RMX-8fc> SYSTEM TO 
BE LOADED INTO MEMORY FROM SOME 
PERIPHERAL DEVICE. 



BOOTSTRAP LOADER FEATURES 


AUTOMATIC OR CONTROLLED LOADING 
AUTOMATIC OR USER SELECTABLE DEVICE 


AUTOMATIC OR USER SELECTABLE FILE NAMES 



DEVICES CURRENTLY SUPPORTED 


• iSBC *04 

• ISBC A06 

• ISBC X\5 

• LsBX RI8 

• Is SC A54 


SINGLE DENSITY FLOPPY DISK 

CDC HAWK HARD DISK 

WINCHESTER DISK 

SINGLE DENSITY FLOPPY DISK 
fWMEN USED WITH iSBC AI5) 

BUBBLE MEMORY CONTROLLER 




BOOTSTRAP LOADER STRUCTURE 


ROM PERIPHERAL PERIPHERAL 

DEVICE DEVICE 
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100 TO 500 BYTES 
+ DRIVER 


6K BYTES 




FIRST STAGE OPTIONS 


• LOCATION OF FIRST STAGE IN ROM 

(ASSIGNED BY USER THROUGH LOi86> 

• LOCATION OF SECOND STAGE IN RAM 

(ASSIGNED BY USER THROUGH LOcBfe) 

• DEVICE SELECTION METHOD 

(ASSIGNED BV USER THROUGH CONFIGURATION') 

• FILE SELECTION METHOD 

(ASSIGNED BY USER THROUGH CONFIGURATION) 
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BOOTSTRAP LOCATION NOTC$ 


FIRST STACaE MUST BE. AVAILABLE AT RESET 

{USUALLY in ROM) 


SECOND STACaE MUST NOT OCCUPY MEMORY 
ALREADY OCCUPIED BY THE SYSTEM TO &£ 
LOADED (CODE AREAS OR INITIALIZED DATA AREAS*) 



DEVICE SELECTION 


NONE Cone device only) 

automatic selection Chvnt for reaov device) 

MANUAL SELECTION CPROMPTUSER FOR DEVICE 

THROUGH SYSTEM TERMINAL) 



DEVICE SELECTION NOTES 


None 


• ONE TRY PER RESET. IF DEVICE IS NOT 

ready: quit. 

AUTOMATIC 

• TRY EACH DEVICE IN THE LIST IN ROTATION 
UNTIL A READY DEVICE IS FOUND. I F NO 
DEVICE IS FOUND REAOY, REPEAT UST. 



DEVICE SELECTION NOTES 

(continued) 


manual 

• PROMPT USER FOR A DEVICE NAME THROUGH 
THE TERMINAL 

IF RESPONSE IS ON THE LIST TRY THAT 
DEVICE 

IF RESPONSE IS NOT ON THE LIST BEGIN 
AUTOMATIC DEVICE SELECTION FROM 
LIST ENTERED AT CONFIGURATION 



file selection notes 


NONE 

• FILE NAMED /SYSTEM/RMX 86 

16 LOADED FROM SELECTED DEVICE. 

AUTOMATIC 

• SAME FILE I* LOADED from THE FIRST 
AVAILABLE DEVICE 


MANUAL 

• IF FIRST CHARACTER IS A COLON, TRY TO 
PARSE A DEVICE NAME. IF DEVICE NAME 
IS IN TABLE TRV IT. 



FILE SELECTION NOTES 

(CONTINUE!)) 

• MANUAL Continued) 

• IF BOOTSTRAP CANNOT PARSE A DEVICE 
NAME OR IF NAME PARSED IS NOT IN THE 

TABLE SWITCH TO RUTO DEVICE SELECTION 

\ 

AND USE STRING AS A FILE NAME. 

• BLANK LINE IS INTERPRETED AS DEFAULT 
FILE NAME /SYSTEM/ RM* 8fc WITH AUTO 
DEVICE SELECTION. 

• FILENAME = : P 0 : /SYSTEM/ FILENAME 

• :f ^: /filename - \$<f>\ filename 
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DRIVER CONFIGURATION 


SUPPLV ADDRESS PARAMETERS 

ASSEMBLE THE RESULT 
EXAMPLE : 

$ INCLUDE C-FX: BX04.INC) 
% B2.04 C0A0H, 1X8, X6) 



(note: these macros chance for each device, see 
CHAPTER II OF the configuration manual) 




Bootstrap configuration 


SELECT DESIRED BOOTSTRAP FEATURES 
LIST BOOTSTRAP DEVICES 
CONFIGURE EACH DEVICE 
ASSEMBLE, LINK AND LOCATE THE RESULT 



SELECT BOOTSTRAP FEATURES 


AUTO MACRO 

(.ENABLES AUTOMATIC DEVICE SELECTION) 

CONSOLE MACRO 

(ALLOWS RUNTIME FILE SELECTION) 

MANUAL MACRO 

Callows runtime device selection) 

IF NO MACROS ARE USED, DEVICE AND FILE 

Selection will revert to defaults with a 
Single try. 



LIST BOOTSTRAP DEVICES 


DEVICE MACRO 

• FOR AUTO SELECT DEVICES ARE SCANNED 
IN ORDER OF THE CONFIGURATION FILE 

• macro specifies: 

•NAME OF DEVICE 

•DEVICE-UNIT NUMBER (SAME AS BIOS') 
•DEVICE INITIALIZATION ROUTINE ENTRY POINT 
•DEVICE READ ROUTINE ENTRY POINT 



DRIVER CONFIGURATION 

(.USER SUPPLIED DRIVERS) 

• YOU CREATE DEVICE ^ IN IT AND DEVICE ^ READ 

routines. 

• ASSEMBLE WITH ENTRY POINTS AS PUBLICS 


• LINK TO REST OF BOOTSTRAP ROUTINES 


(note: ROUTINES must BE laroe model of 

COMPUTATION) 



EXAMPLE BOOTSTRAP CONFIGURATION C<) 


• NO DEVICE SELECTION 

* 


NAME SIMPLE 
^INCLUDE (:fx: BSl.INC) 

% DEVICE (wF0,0, DEVICE INIT ^I5"j DEVICE READi^') 

%END 



EXAMPLE BOOTSTRAP CONFl6URATION(S) 

• MANUAL (with device selection) 

$ INCLUDE (fx: BS1.INC.) 

% console 

% AUTO 
%MANUAL 

% DEVICE (f 0, 0, DEVICE INIT^04- y DEVICE READ *04-”) 
% DEVICE Cb0,l / DEVICE IN IT *^4, DEVICE READ 

% END 



EXAMPLE. BOOTSTRAP CONFIGURATION^) 
(ASSEMBLE, LINK AND LOCATE) 

(SIMPLE CASE) 


•AFTER BOOTSTRAP CONFIGURATION FILE AND 
DEVICE CONFIGURATION FILES) ARE PREPARED 

SUBMIT :fx: BS1 (date,rom,ram) 

WHERE*. DATE = DATE IE 07/v*/8X 

ROM = STARTING CODE ADDRESS 
FOR STAGE 1. 

RAM = STARTING ADDRESS FOR 
STAGE X. 

NOTE*. MODIFY ’.fx'. foSl.CSD To REFLECT YouR 
ARRANGEMENT BEFORE YOU SUBMIT. 



EXAMPLE BOOTSTRAP CONF16URATION 
(.ASSEMBLE, LINK AND LOCATE) 
(COMPLEX CASE) 


STEP 1. 

COMPILE 

:fx*. BCIC0.P86 TO CjET CONSOLE 
Routines for device or file selection 

STEP X. 

ADD 

:fx: 

LINK 

BCICO. OBJ TO SUBmiT FILE 
LIST. 

STEP 3. 

Submit 

:Px: 

BSlC , , ) 



CHAPTER QUIZ. 


1. WHAT ARE THE THREE MOOES OF LOADING? 

A • B • C • 

WHAT ARE iOP THE DEVICES I CAN BOOT FROM? 
A. R. 

3. HOW DOES THE SECOND STAGE 6 ETON THE DEVICE? 

4*. WHAT IS THE FILE NAME FOR THE CONSOLE INTERFACE 
FILE? 
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CMPTER 4- 

THE FILES UTILITY 





I 


V/HKT IS IT ? 

• THE FILES UTILlTV ISA PROGRAM RUNNING 

ON AN RMX-86/lSJS SYSTEM WHICH 
ALLOWS YOU TO CREATE RMX-86 FORMAT 

diskettes before you have a working user 

created 5VSTEM . 




FILES UTILITY FUNCTIONS 

•format an rmx-bs diskette. 

• COPY FILES FROM AN RMX-8t» DISKETTE TO AN 
ISIS FORMAT DISKETTE. 

•COPV FILES FROM AN ISIS FORMAT DISKETTE To 
AN RMX-8E FORMAT DISKETTE 
•DELETE FILES ON AN RMX-B& DISKETTE 
•CREATE a DIRECTORY FILE ON AN RMX-fcfc DISKETTE 
•DISPLAY THE CONTENTS OF AN RMY-84* DISKETTE 
DIRECTORY IN SEVERAL FORMATS 



HARDWARE. REQUIRED 

INTEL DEVELOPEHENT SYSTEM WITH fe4K RAM 
AND AT LEAST ONE DISK DRIVE 

£MDS-SOO, SERIES H, SCRIES HE, NOS-'l) 

LS6C S&/ 12 A WITH AT LEAST m K RAM AND 
AT LEAST 1 Ol SK DRIVE 

4S7A INTE.LLEC TO 8fc/|2.A INTERFACE AND 
MONITOR 



WHERE POES THE FILES UTIUTVFIT IN? 


STEP 1. DEVELOP USER SOFTWARE ON THE INTELXEC 
SYSTEM (^SERIES XT, SERIES TIT, MDS 600) 

6TE.PJL TEST LOAD AND EXECUTE SOFTWARE USING, THE 
^ 51 - A INTERFACE 

STEP 3. FORMAT A BOOTABLE disk and load tested software 
ONTO it 

STEP 4. PLACE BOOTSTRAP STA6E X INTO 6 <oflXf\ PROM. 

STEP 5. Set UP {.SBC SYSTEM, load diskette from STEP 3 
INTO A DRIVE AND PRES-b RESET. 



FILES UTILITY USAGE 


TO INVOKE THE FILES VTIUTY 

a. SET UP HARDWARE AND SOFTWARE 

b. TYPE 

SUBMIT :F*: FILES (:F*:) 
SBC8<ol 



FILES UTILITY COMMANDS 


COMMAND 

ABBREVIATION 

ATTACH D El VKE 

AD 

BREAK 

BR 

CREATE DIR 

CD 

delete 

DE 

DETACH 

PT 



FILES UTILITY COMMANDS 

(COMT.T 


command 

abbreviation 

PIR 

pi 

POWN 60 PY 

PC 

FORMAT 

FO 

HELP 

HE 

UPLOPY 

uc 



ATYPICAL FILES UTILITY USAQE SEQUENCE 


-SUBMIT : FI : FILES (s FIs) 

-SBC861 

ISIS-II iSBC 86/12 LOADER, V2.0 

iSBC 86/12 MONITOR V2.0 

. L: FI : NUCLUS 
. L: FI : IOS 
. L: FI : EIOS 
. L: FI : FILES 
. L: FI : FROGT 
.E 

- : F0 : SUBMIT RESTORE : FI : FILES . CS ( : VI : ) 
-SBC861 

ISIS-II iSBC 86/12 LOADER, V2.0 
♦CONTROL-C* 

• G 

iRMX 86 FILES UTILITY V3.0 

♦FORMAT F0 LAB 2 IL=5 NF = 50 NAMED 

♦VOLUME FORMATTED - NAMED FILE OPTION 

GRANULARITY =128 
NUMBEROFNODES = 50 
INTERLEAVE = 5 



ATYPICAL FILES UTILITY USAGE SEQUENCE 


*AD :F0: = F0 
*DIR : FG : 

0 FILES 

*CREATEDIR :F0:SYSTEM 

:F0: SYSTEM , CREATED 

*UPCOPY : FI: FIRST. LIB TO : F0 : SYSTEM/RMX86 
*DIR :F0: 

SYSTEM 

1 FILES 

*DIR :F0: SYSTEM 
RMX86 

1 FILES 
*DETACH :F0: 


: F0 : 


DETACHED 



A TYPICAL FILES UTILITY USAOE SEQUENCE 


*BREAK* AT 1800: 186A 



WARNING* ijj 


TO CHANGE A DISKETTE’. 

1. DETACH 

A. CHANGE DISKETTES 


3 , ATTACH DEVICE (OR FORMAT) 



CHAPTER QUIZ 

1. TRUE-FALSE THE FILES UTILITY ALLOWS YOU TO 

DISPLAY THE DIRECTORY OF AN ISIS 
DISKETTE. 

X. NAME THREE DEVICES THAT CAN BE FORMATTED BY THE 
FILES UTILITY. 

a. b C. 

3. WHY CANT I REMOVE A DISKETTE AT ANYTIME WHILE 
I'M USING* THE FILES UTILITY? 
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WRITING DEVICE. DRIVERS 
FOR THE IRMX 86 T/o SYSTEM 



TOPICS TO SE DISCUSSED*. 


• INTRODUCTION and concepts 

• DEVICE DRIVER INTERFACES 

• COMMON DEVICE DRIVERS 

• RANDOM ACCESS DEVICE DRIVER5 

• CUSTOM DEVICE DRIVERS 

t 

• DEVICE DRIVER CONFIGURATION 



reference manuals required*. 


• IRMX 86 BASIC X/o SYSTEM REFERENCE MANUAL 

• IRMX 86 SYSTEM PROGRAMMERS REFERENCE MANUAL 

• IRMX 86 CONFIGURATION GUIDE 

• GUIDE TO WRITING DEVICE DRIVERS FOR THE 
IRMX 86 Vo SYSTEM 



SYSTEM CONSTRUCTS 


• THE I/O SYSTEM IS IMPLEMENTED AS A SET OP FILE 
DRIVERS AND ASET OF DEVICE DRIVERS 

• YOUR APPLICATION COMMUNICATES WITH FILE DRIVERS 

1. PHYSICAL 

USARTS, PRINTERS 

X. NAMED 

DISK, BUBBLE MEMORY 

3. STREAM 

A PIPELINE BETWEEN TWO TASKS USING 
r/o SYSTEM CALLS 
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SYSTEM CONSTRUCTION 


FILE DRIVERS COMMUNICATE WITH DEVICE DRIVERS 

DEVICE DRIVERS COMM UN I CATE WITH DEVICES 

APPLICATION TASKS 

FILE INDEPENDENT INTERFACE 

FILE DRIVERS 

DEVICE INDEPENDENT INTERFACE 

DEVICE DRIVERS 

DEVICES 



INTBR FACE 


• THE INTERFACE BETWEEN YOUR APPLICATION AND 
FILE DRIVERS AND BETWEEN FILE DRIVERS AND DEVICE 
DRIVERS IS STANDARD 

• THIS ALLOWS FOR: 

- DEVICE INDEPENDENCE 
~ HARDWARE CONF 16 URATION CHANCES 
WITHOUT EXTENSIVE SOFTWARE 

Modifications 

~ A GREATER RAN6E OF DEVICESCAN 

BE supported 


5-(o 



Vo DEVICE AND DEVICE DRIVERS 


• EACH T /o DEVICE CONSISTS OF A CONTROLLER AND 
ONE OR MORE UNITS 

• EACH CONTROLLER IS ASSIGNED A DEVICE NUMBER 


• EACH UNIT IS ASSIGNED A UNIT NUMBER FOR THAT 
DEVICE AND A DEVICE UNIT N UMBER FOR ALL DEVICES 
IN THE T/O SYSTEM 
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SCHEMATIC OF SOFTWARE AT INITIALIZATION TIME 
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%> REQUESTS 

TO THE DEVICE DRIVER A REQUEST IS A REQUEST FROM THE 
r /o SYSTEM FOR THE DEVICE To PERFORM A CERTAIN OPERATION 

• READ 

• WRITE 

• SEEK 

« SPECIAL 

• ATTACH DEVICE 

• DETACH DEVICE 

• OPEN 

• CLOSE 

THESE REQUESTS ARE PASSED TO THE DEVICE DRIVER IN 
•A SEGMENT TYPE OBJECT 
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COMPONENTS OF DEVICE DRIVER 

• AT ITS HIGHEST LEVEL A DEVICE OPERATOR CONSISTS 
OF FOUR PROCEDURES 

• INITIALIZE I/O 

• FINISH */o 

• QUEUE VO 

• CANCEL VO 


FOR EVERY I/O REQUEST THE x /o SYSTEM MAY CALL ONE OR 

More of these procedures 


I 
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INITIAL */o PROCEDURE. 


• THE Yo SYSTEM CALLS THIS PROCEDURE WHEN EVER 
A RQ$ PHYSICALS ATTACH$DEVICE SYSTEM CALL IS MADE 
AND THERE ARE CURRENTLY No OTHER UN ITS ATTACH ED 
TO THIS DEVICE 
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FINISH I/O 


• THE Vo SYSTEM CALLS THIS PROCEDURE WHENEVER 
A RQ$PHYS(CAL$ DETACH $ DEVICE SYSTEM CALL IS MADE 
AND THERE ARE CURRENTLY NO OTHER UNITS ATTACHED 
TO THIS DEVICE 



QUEUE I/O 


• THIS PROCEDURE IS CALLED BY THE I/o SYSTEM FOR 
ALL USER VO REQUESTS. THIS PROCEDURE MUST 

place the request on the request queue so 

THAT IT MAY BEPROCCESSED WHEN APPROPRIATE. 

IF DEVICE IS NOT BUSY THIS PROCEDURE MUST ALSO 
START THE I/O FUNCTION 
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CANCEL Vo 


• THIS PROCEDURE 1$ CKUED BY THE Vo SYSTEM WHEN*. 

• A RQ^Ai PHYSICAL !^DETACH$ DEVICE CALL IS 
MADE WITH THE HARD DETACH OPTION SPECIFIED 

• IFTHE JOB containing THE TASK THAT MADE 
THE Vo REQUEST SELECTED 
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INTERRUPT HANDLERS 


• AFTER A DEVICE HAS FINISHED PROCESSING AN 
I/O REQUEST IT SENDS AN INTERRUPT TO TH E 
PROCESSOR. 

AT THIS TIME THE HANDLER MAY SERVICE THE 
INTERRUPT OR SIGNAL AN INTERRUPT TA&K THAT 
WILL SERVICE THE INTERRUPT 

REMEMBER THAT AN INTERRUPT HANDLER ISLIMITED 
TO THE TYPE OF RMX CALLS THAT IT MAY MAKE 
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INTERRUPT TASKS 


INTERRUPT TASKS FEED THE RESULTS OF THE 
r /o REQUEST BACK TO THE */o SVSTEM IF THE 
REQUEST IS FINISHED. 

IF THE REQUEST IS NOT FINISHED THIS TASK 
WILL INITIATE THE NEXT STAGE OF THE REQUEST. 

IF THERE ARE ADDITIONAL REQUESTS ON THE 
QUEUE THEN THIS TASK MUST START THE 
NEXT REQUEST. 
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DEVICE DRIVER TYPES 


• COMMON DEVICE DRIVERS 

EASIEST TO IMPLEMENT 

• RANDOM ACCESS DEVICE DRIVERS 

MUCH THE SAME AS COMMON DEVICES 

• CUSTOM DEVICE DRIVERS 

More complex than common or random 

NEEDED FOR MORE SOPHISTICATED DEVICES 
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COMMON Device REQUIREMENTS 


• SIMPLE DEVICES - PRINTERS, USARTS 


• DATA EITHER READ OR WRITTEN TO THE DEVICE 
DOES NOT NEED TO BE BROKEN VP INTO 
SPECIFIC BLOCK SIZES 

• A FIRST IN/ FIRST OUT QUEUE FOR THE 
REQUESTS IS SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL IS NEEDED FOR THE 
DEVICE 
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random access device driver requirements 

• DEVICES SUCH AS DISKS AND BUBBLE MEMORY 

• THE DEVICE MUST SUPPORT RANDOM ACCESS SEEK 

• THE Vo REQUEST MUST BE BROKEN UP INTO 

SPECIFIC BLOCK LENGTHS 
(TRACK AND SECTOR, BUBBLE PACE") 

• A FIFO QUEUE 15 SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL 15 NEEDED FOR THE DEVICE 
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CUSTOM DEVICE DRIVER REQUIREMENTS 


• IF THE DEVICE DOES NOT FIT INTO THE CAT GORY 
OF EITHER COMMON OR RANDOM ACCESS THEN YOU 
MUST WRITE A CUSTOM DEVICE DRIVER 


♦ ANY DEVICE THAT REQUIRES PRIORITY QUEUES 


• ANY DEVICE THAT REQUIRES MORE THAN ONE INTERRUPT 
LEVEL 


• ANY DEVICE THAT REQUIRES THE INTERRUPT HANDLER 
TO SERVICE MORE THAN ONE INTERRUPT BEFORE 
SIGNALLING THE INTERRUPT TASK 
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DEVICE DRIVER QUIZ-*1 

L WHAT ARE THE THREE TYPES OF RLE DRIVERS*? 

X. APPLICATION TASKS CALL FILE DRIVERS -(TRUE -FALSE) 

3. WHAT IS THE DIFFERENCE BETWEEN A DEVICE AND 
A UNIT? 

4. WHAT OBJECT TYPE IS AN I/O REQUEST? 

5. WHAT ARE THE COMPONENTS OF THE DEVICE DRIVER? 

6. WHEN IS THE INITIALIZE I/O PROCEDURE CALLED? 

7. WHAT ARE THE DIFFERENCES BETWEEN A COMMON 
AND A CUSTOM DEVICE DRIVER? 
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DEVICE DRIVER INTERFACES 
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ALL DEVICE DRIVER INTERFACES ARE IN THE FORM 
OF DATA STRUCTURES 

THERE ARE TWO I/O SVSTEM INTEFACES 

DEVICE-UNIT INFORMATION BLOCKS - DU IBS 
Vo REQUEST/ RESULT SEGMENTS - IORS 

DEVICE INTERFACES DEPEND ON THE DRIVER TVPE 
FOR BOTH COMMON AND RANOOM ACCESS DEVICES 
THE COMMON DEVICE INFORMATION BLOCK IS USED 
OTHER DEVICE INTERFACE STRUCTURES ARE USER 
DEFINED 



DEVICE UNIT INFORMATION - OUlfc 
THIS STRUCTURE HAS THE FOLLOWING FORMAT*. 
DECLARE DEV$UNIT$INFO$ BLOCK STRUCTURE ( 


NAME (14} 

FILE $ DRIVERS 

FUNCTS 

FLAGS 

DEV $ GRAN 

LOW$DEV$SIZE 

HUaH$DEV$SIZE 

DEVICE 

UNIT 

DEV^UNIT 


BYTE, NAME USED IN ATTACHDEVICE 
WORD, WHAT FILE DRIVERS CAN BE USED 
BYTE, WHAT FUNCTIONS ARE SUPPORTED 
BYTE, FOR DENSITY AND SIDE SPEC ON DISKS 
WORD, FOR DISKS MIN I/O SIZE 
WORD, THE SIZE OF THE DEVICE IN BYTES 
WORD, 

BYTE, THE T/o SYSTEM DEVICE NUMBER 
BYTE, UN IT NUMBER FOR THIS DEVICE 
WORD, THE DEVICE UNIT NUMBER 
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DEVICE UNIT INFORMATION - DUI& 

(CONTINUED) 


INlT$IO 
FINISH ilO 
QUEUE $IO 
CANCEL^IO 
DEVICE^ INFO$P 
UNIT$INFO$P 
UPDATE$TlME$OUT 
NUM^ BUFFERS 
PRIORITY 


WORD, PROCEDURE ADDRESSES 
WORD, 

WORD, 

WORD, 

Pointer, to device info 
pointer, to unit info 

WORD, NUMBER OF SYS TIME UNITS 

WORD, NUM BUFFERS FOR PAD DEVICE 
BYTE, PRI FOR I/O SERVICE TASK 
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USING DU16S 


• THE tyo SYSTEM USES THE DVlB TO INVOKE THE DEVICE 
DRIVER PROCEDURES WHENEVER AN I/O REQUEST IS MADE. 


• WHEN AN ATTACH DEVICE CALL IS MADE THE I/O SYSTEM 
WILL SCAN THE DVIB TABLES FOR A NAME MATCH. 

EXAMPLE: 

CALL RQ$A$PHVSICAL$ ATTACH$DEVICE (©( b, 'STREAM'), 

X, RMBX, Q status); 

THERE MUST BE A DUIB FOR THE DEVICE NAME 'stream' 

AND IT MUST HAVE STREAM FILE DRIVER CAPA6U-ITV 





DEVICE. DRIVER INTERFACED 

attaching devic.ec 


NAU£ * UNIT A 

DC VAGRAN = US 

«* 

p 

DEV ICE a X 

UNIT ao 

oev$UNlT j fr 


CALL RQ$A^PHY'StCAL$ATTACH$ DEVICE (uNITA,...') 


NM1£ * UNIT AX. 
DEV^GftAN *StX 


OEVICE * X 
UNIT » O 
OEVjUNlT a 


DUIB 5 FOP 
DEVICE UNtTfc 


NAME * UNITB 


NAME ~ UN IT BX 

DEV$6RAN * 1X8 
0 


DEV ^CiRAN =SXX 

DEVICE S 1 


« 

• 

UNIT 2 X 


OEVlCE - X 
unit = X 

d£v$uniT 2 * 


DEV fUNlT » ■? 


CALL rq$phys»cal$attach$device (unitb. 


DUlBD FOR 
DEVICE UNIT 7 


■) 


ftAME * UNIT*. 
PEV^GRAN = 1*8 
# 

DEVICE = X 
UN lT 2 X 

D6V$UNlT - 8 


NAN£ - UNITCl 
DEV $ ORAN = T» 2 , 

DEVICE -X 
UNIT *» X 

DELIMIT =3 


J 


DVIB 5 FOR 
DEVICE UNIT 8 


CALL RA$A^PHVSICAI^ATTACH4PEVIC£(unITCL,.. .) 
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DUPLICATION DEVICES 

• YOU MAY DUPLICATE DEVICE AND UNIT NUMBERS IN 
SEPARATE DU IBS IN ORDER TO HAVE DIFFERENT 
CHARACTERISTICS FOR THE SAME DEVICE 

• FOR EXAMPLE IF YOU HAVE A DISK DRIVE THATCANHAVE 
DIFFERENT SECTOR SIZES AND YOU MIGHT WANT TO HAVE 
ONE INSTANCE FOR 1X8 BYTE SECTORS AND ONE FOR 
X5G BYTES 

TO DO THIS YOU DUPLICATE THE DUIB WITH THE EXCEPTION 
OF THE NAME AND DEV $ GRAN FIELD 
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THE I/O reqest/result structure HAS THE FOLLOWING FORMAT'. 

DECLARE IORS STRUCTURE* C 


STATUS 

WORD, 

CONDITION CODE FOR THE OPERATION 

UN IT$ STATUS 

WORD, 

IF STATUS IS E$10 THEN UNIT STATUS SHOULD 
BE SET 

ACTUAL 

WORD, 

THE ACTUAL AMOUNT OF DATA TRANSPE RED 

ACTUAL^ PILL 

WORD, 

RESERVED 

DEVICE 

WORD, 

THE DEVICE NUMBER (SAME AS DVIfc} 

UNIT 

byte, 

the UNIT NUMBER (same as doib) 

FUNCT 

BYTE, 

THE FUNCTION TO BE PERFORMED 

SU6 $ FUNCT 

WORD, 

USED FOR SPECIAL CALLS 

lqW$dev$loc 

WORD, 

THE DEVICE LOCATION IN BYTES, FOR RANDOM 

HI6H$DEV$LOC 

WORD, 

ACCESS DEVICES THIS 15 THE SECTOR AND TRACK 
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declare iors structure ( 

^continued} 


BUFF $ P 

POINTER, 

WHERE THE DATA IS TO BE READ FROM 
OR WRITTEN TO 

COUNT 

WORD, 

HOW MUCH, IF RANDOM ACCESS THIS 
WILL ALWAYS BE IN DEVICE ORAN. 
MULTIPLES 

Count $fill 

WORD, 

RESERVE 

AUX$P 

POINTER, 

USED FOR SPECIAL CALLS 

link^for 

POINTER, 

LINKED LIST FOR I/O REQUEST QUEUES 

LINK* BACK 

POINTER, 


RESP$MBX 

WORD, 

THE RESPONSE MAILBOX FOR THIS REQUEST 

done 

BYTE, 

I/O REQUEST STATUS 

FI LL 

BYTE, 

RESERVE 

CANCELED 

word); 

THE REQUEST I.D. FOR THE REQUEST 


5-30 



COMMON DEVICE INFORMATION INTERFACE 

• THIS STRUCTURE IS USED FOR ALL COMMON AND RANDOM 

access Device drivers 

DECLARE COMMON $DEV$lNFO STRUCTURE ( 


LEVEL 

WORD, 

THE INTERRUPT LEVEL- USED FOR this device 

PRIORITY 

BYTE, 

THE INITIAL PRIORITY OF THE INTERRUPT TASK 

STACKiSlZE 

WORD, 

THE ADDITIONAL AMOUNT OF STACK THAT 
YOUR P 

DATA$SI2-E 

WORD, 

THE AMOUNT OF DATA SPACE THAT YOUR 
Device driver needs, cnot static data) 

MUM i UNITS 

WORD, 

HOW MANY UNITS ARE WITH THIS DEVICe 

DEVICE^INIT 

WORD, 

Your init procedure 

DEYIC£$FINISH 

WORD, 

YOUR FINISH PROCEDURE 

DEVICE^ START 

WORD, 

YOUR start procedure 

DEVICE^ STOP 

WORD, 

YOUR STOP PROCEDURE 

Device $ interrupt 

word); 

Your interrupt procedure 


You MAY APPEND) TO THIS STRUCTURE ANY INFORMATION THATYOUR DEVICE 

Needs, such as r/o addresses 
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RANDOM ACCESS DEVICE UNIT INFORMATION BLOCKS 


• For random access device you must have a unit 

INFORMATION BLOCK 

DECLARE 

RAd^un it$ info $ block structure ( 

track$siz.e 

MAX $ RETRY 

RESERVED 

You MAY APPEND TO THIS STRUCTURE AMD INFORMATION BY 

THE DEVICE 


WORD, THE SIZE IM BYTES OF 
A TRACK 

WORD, THE MAX NUMBER OF RETRIES 
TO BE PERFORMED BY THE Vo 
. SYSTEM 

WORD): 
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WRITING DEVICE DRIVER 



GENERAL RULES 


• IF PL/M 86 IS USED TO WRITE DEVICE DRIVERS THEM 
THE COMPACT MODEL OF COMPILATION MUST BE USED. 


• IF ASMSfc IS USED THEN IT MUST BE WRITTEN To 
INTERFACE TO COMPACT PL/M 86 PROCEDURES 

• THE I/o SYSTEM CODE CAN NEVER EXCEED 64K OF 
COPE 
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WRITING COMMON AND RANDOM 
ACCESS DEVICE DRIVERS 



"THERE ARE CERTAIN PARAMETERS PASSED TO EACH DEVICE 


rv tr% iti 

uisnr cK 


PROCEDURE 


• Dl»lP$P - A POINTER to THE DUlB STRUCTURE for the 

DEVICE 


• DSDATA^P- A Pointer to the data obtect that was 

DECLARED IN THE COMMON DEVICE INFORMATION 
BLOCK 


• IORS$P - A POINTER TO THE I/° REQUEST SEGMENT 


• STATUS ^.P - A POINTER TO THE r /° SYSTEM STATUS WORD 
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I/O SYSTEM SUPPLIED PROCEDURES 

• INIT$lO 

• F|NlSH$IO 

• QUEUE $10 

• cancel $ro 


USER SUPPLIED PROCEDURE 

• A DEVICE INITIALIZATION PROCEDURE 

• A DEVICE FINISH PROCEDURE 

• A DEVICE START PROCEDURE 

• A DEVICE STOP PROCEDURE 


A DEVICE INTERRUPT PROCESSING PROCEDURE 



THE ADDRESSES OF YOUR DEVICE. DRIVER 
PROCEDURE MUST 6E PLACED IN THE COMMON 
DEVICE INFORMATION BLOCK FOR THE DEVICE 
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DEVICE INITIALIZATION PROCEDURE 


THE init^io procedure call this procedure to 

INITIALIZE, THE DEVICE 

THE FORM OF THECALL IS*. 

CALL DEVICE^INIT^DUIB^P, O^P, 5TATUS$p}j 

YOU MUST INITIALIZE YOUR DEVICE AND ANY VARIABLES 
AND SET THE STATUS WORD To INDICATE. THE SUCCESS 
OR FAILURE OF THIS PROCEDURE 

IF YOUR DEVICE DOES NOT NEED ANY INITIALIZATION THEN 
YOU MAY USE THE DEFAULT ^ IN IT PROCEDURE SUPPLIED 
BY THE I/O SYSTEM 



DEVICE FINISH PROCEDURE 

THE FINISH^IO PROCEDURE CALLS THIS .PROCEDURE 
AFTER THE LAST REQUEST HAS SEEN PROCESSED 

THE FORM OF THE CALL IS*. 

CALL DEVICE ^FINISH (DU|B$P, D$DATA$P)^ 

YOU MUST DO ANY FINAL PROCESSING FOR YOUR PEVICE 
WHEN THIS PROCEDURE IS CALLED 


IF YOUR DEVICE DOES NOT NEED ANY FINAL PROCESSING 
THEN YOU MAY USE THE DEFAULT^ FINISH PROCEDURE 

Supplied by the x/o system 
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DEVICE START PROCEDURE 


Both queue$io and the interrupt task call this 

PROCEDURE IN ORDER TO START AN X/o FUNCTION 

QUEUE$lO CALLS THIS PROCEDURE WHEN A REQUEST 
IS MADE AND THERE ARE NO REQUESTS ON THE QUEUE 

THE INTERRUPT TASK CALLS THIS PROCEDURE WHEN AN 
Vo REQUEST IS COMPLETED AND THERE ARE ADDITIONAL 
REQUESTS IN THE QUEUE 

THE FORM OF THE CALL IS*. 

call device$start(iors£f> DUlB^ , 

D^DATA^P”); 
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Device START PROCEDURE REQUIREMENTS 

• START THE DEVICE PROCESSING THE REQUEST 

• REC 06 NIZ.E INVALID REQUESTS 


• IF DATA TRANSFERS OCCUR THEN UPDATE THE IORS. 
ACTUAL FIELD 

• IF AN ERROR OCCURS UPDATE THE IORS, STATUS AND 
IORS. UN IT ^STATUS FIELDS 

• IF THE REQUEST IS COMPLETE SET THE IORS. DOME 
FIELD TO TRUE 
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DEVICE STOP PROCEDURE 

THIS PROCEDURE IS CALLED TO STOP THE T/O DEVICE 
FROM PERFORMING THE CURRENT I/O FUNCTION 

THE FORM OF THE CALL |S‘. 

CALLDEVICE$STOP(rORS$P, DUIfc$P, D^DATA^p); 

IF YOUR DEVICE GUARANTEES THAT ALL I/O REQUESTS WILL 
FINISH WITHIN A REASONABLE AMOUNT CFTIME THEN YOU 
MAY USE THE DEFAULT^ STOP PROCEDURE 
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DEVICE INTERRUPT PROCEDURE 

THE DEVICE INTERRUPT TA5K CALL THIS PROCEDURE WHEN 
AN INTERRUPT HAS BEEN GENERATED BY THE DEVICE 

THE FORM OF THE CALL IS*. 

CALL DEVICE^ !NTERRUPT(lORS$P, DU10$P ( D$DATA^P); 


Your interrupt procedure must determine ip the 
request is finished and set the iors.done field 
true if it is. 

IF IT IS NOT COMPLETE YOU MUST INITIATE THE NEXTSTEP 
IN THE PROCEDURE. 
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DEVICE INTERRUPT PROCEDURE 


EXAMPLE*. 

l.YOUR APPLICATION TASK MADE A RQ$A$READ CALLTO A 
DISK. 

X. Your start procedure initiated a seek request 

FOR A DISK DRIVE TO POSITION "THE HEAD OVER THE 
PROPER TRACK. 

3. THE DEVICE GENERATED AN INTERRUPT TO SIGNAL THE 
COMPLETION OF THE SEEK FUNCTION. 

4. THE INTERRUPT procedure STARTED THE READ FUNCTION 
ON THE DISK. 

5. THE DISK GENERATED AN INTERRUPT WHEN THE DATA TRANSFER 
WAS COMPLETE. 

b. THE INTERRUPT PROCEDURE SET THE TORS, ACTUAL FIELD AND 

THE IORS.DONE FIELD TO INDICATE THE REQUEST WAS COMPLETE 



COMMON AND RANDOM ACCESS DEVICE DRIVER 

QUIZ. 

1. THE MINIMUM NUMBER OF PROCEDURES THAT YOU MUST 
WRITE IS? 


X. HOW DOES THE I/O SYSTEM KNOW WHEN THE REQUEST 
IS COMPLETE? 

3. HOW DOES THE DEVICE DRIVER INFORM THE I/O SYSTEM 
OF THE SUCCESS OR FAILURE OF A REQUEST? 


4. HOW DOES THE I/O SYSTEM KNOW WHAT DEVICE DRIVER 
PROCEDURES TO CALL? 

5. HOW DOES A DEVICE DRIVER KNOW WHAT THE T/O PORT 
ADDRESSES ARE FOR ITS DEVICE? 
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WRITING) CUSTOM DEVICE DRIVERS 
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CUSTOM DEVICE DRIVER PROCEDURES 

• lNIT$IO - DEVICE INITIALIZATION PROCEDURE 

• FINISH^IO - device finish procedure 

• OUEUE^IO - DEVICE QUEUE I/o REQUEST PROCEDURE 

• CANCEL^IO - DEVICE CANCEL I/o PROCEDURE 

YOU MUST WRITE THESE PROCEDURES AND AN INTURRUPT 
TASK AND HANDLER IF NEEDED 
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INIT$ro PROCEDURE 

THIS 16 CALLED BY THE I/O SYSTEM WHEN THE FIRST ATTACH 
DEVICE CALL IS MADE. 

THE FORM OF THIS CALL IS'. 

CALL lNIT$ro£DlMB$ P, D$DATA$P, STATUSS.P'); 

DUlB^P - A POINTER TO THE DUlB FOR THE DEVICE TO BE INITIALIZED 

D^OATA^P - A POINTER TO THE WORD WHERE VOU MWT STORE THE 

TOKEN FOR A SEGMENT O&TECT IF NEEDED BV YOUR DEVICE. 

THIS SEGMENT MAY CONTAIN DATA SUCH AS A REGION TOKEN 
FOR THE QUEUE, APOINTER To THE FIRST IORS ON THE 
QUEUE AND A TOKEN FOR AN INTERRUPT TASK IF NEEDED. 

STATUS$P ” APOINTER TO AWORD WHERE YOU MUST STORE THE RESULTS 

OF THIS CALL 


note; if no data object is needed you must return -z-Efto as a token. 
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a possible flow for this procedure 

MIGHT BE: 

1* CREATE A SEGMENT FOR ADATA OBJECT 
X* CREATE A REGION FOR ACCESS TO A QUEUE 


> 3 • CREATE AN INTERRUPT TASK FOR THE DEVICE 


4- • SET THE QUEUE TO EMPTY 

5» INITIALISE THE DEVICE HARDWARE AND ANY VARIABLES 
NEEDED 

IF ALL WENT WELL THEN SET STATUS TO E$OK 
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finish r/o procedure 

THE I/O SYSTEM CALLS THIS PROCEDURE AFTER THE LAST DETACH 
DEVICE CALL IS HADE ON TH IS DEVICE 

THE FORM OF THE CALL IS'. 

call finish$io(dimb d$data$t); 

DUIB^P — A POINTER TO the DUlB FORTHli device un»t 
D$DATA$T — A TOKEN FOR THE DATA OBTEC.T SEGMENT 


THE FINISH I/O PROCEDURE MUST DO ANY FINAL PROCESS ING 
ON THE DEVICE IF NEEDED AND DELETE ANY OBJECT THE 
IN IT $10 PROCEDURE CREATED 

(SEGMENT, REGION, RESET INTERRUPT TASK....) 
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QUEUE $10 PROCEDURE 

THIS PROCEDURE IS CALLED FOR EVERY REQUEST To THE DEVICE 
DRIVER. 

THE FORM OF THE CALL IS*. 

CALL QUEUE^Io(roRS$T i DUlB$P / DSDATA^ ); 
lORS$T ” A TOKEN FOR THE I/O REQUEST SEGMENT 

THIS PROCEDURE MUST DO THE FOLLOWING'. 

1. IF THE DEVICE IS BUSY PLACE THE REQUEST ON THE QUEUE 

3,. IF THE DEVICE IS NOT BUSY THEN START THE I/O FUNCTION 

3. IF THE REQUEST CAN BE COMPLETED WITHOUT PLACING 
THE TORS ON THE QUEUE THEN SET THE TORS. DONE 
FIELD To TRUE 

NOTE*. WHENEVER ACCESSING THE QUEUE YOU MUST FIRST GAIN 
ACCESS TO IT BY RECIEVIN6 CONTROL OF THE REGION 
THAT PROTECTS IT. 
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CANCEL $IO 

THIS PROCEDURE IS CALLED BY THE X/O SYSTEM WHENEVER 
A HARD DETACH DEVICE SYSTEM CALL IS MADE ORA JOB 
DELETED THAT STILL HAS- REQUESTS PENDING. 

THE FORM OF THE CALL IS*. 

CALL CANCE$IO(CANCEL4rD, DUIB$P, P$DATA$t); 
CANCEL^ ID - the id for requests that are to be 

REMOVED FROM THE QUEUE. 


THIS PROCEDURE MUST REMOVE ANY REQUEST FROM THE 
QUEUE THAT CONTAIN THE CANCEL ID VALUE 
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IMPLEMENTING, a I/O REQUEST QUEUE 

WHEN WRITING CUSTOM DEVICE DRIVERS YOU MUST HAVE 
SOMESORT OF QUEUE FOR INCOMING REQUESTS. 

THE IORS SE6MENT CONTAINS TWO FIELDS THATAUjOW 
FOR A LINKED LIST 

IORS.LINK^FOR, IORS. LINK$BACK 

THESE TWO POINTER VALUES CAN BE USED TO IMPLEMENT 
A QUEUE 

IF IN YOUR DATA OBJECT YOU HAVE A VALUE CALLED FIRST^TORS 
THAT IS SET TO ZERO TO INDICATE AN EMPTY QUEUE. 

WHEN A REQUEST NEEDS TO B>£ QUEUED YOU CAN SET THIS 
FIELD TO POINT TO THE FIRST TORS AND THE LINK FIELDS 
OF THE TORS TO POINT BOTH FORWARD AND BACK IN THE 
QUEUE. 
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Request queue 


l 


FIRST IORS SECOND IORS THIRD iors LKST TORS 

ON QUEUE ON QUEUE ON QUEUE ON QUEUE 
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INTERRUPT TASKS 

INTERRUPT TASKS ARE USED TO RESPOND To THE INTERRUPT 
GENERATED BY THE DEVICE. 

THE INTERRUPT TASK MUST DO THE FOLLOWING!*. 

1. SERVICE THE INTERRUPT 

X. DETERMINE IF THE REQUEST tS COMPLETE 

3. IF COMPLETE, GAIN ACCESS TO THE QUEUE 

REMOVE THE IORS FROM THE QUEUE. 

SET THE IORS.DONE FIELD TO TRUE. 

SEND THE IORS TO THE MAILBOX INXORS.RMBX. 

IF THE QUEUE IS NOT EMPTV THEN START THE NEXT 
REQUEST. 

4. IF THE REQUEST IS NOT COMPLETE THEN INITIATE 
THE NEXT PROCESS. 
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QUIZ #3 - CUSTOM DEVICE DRIVERS 


1. WHAT 15 THE PURPOSE OF THE DATA OBTECT? 


2L WHEN IS THE CANCEL T/o PROCEDURE CALLED? 


3. IS IT POSSIBLE TO USE DEFAULT I/O PROCEDURES 
WITH CUSTOM DEVICE DRIVER? 

4. WRITE A PROCEDURE To PLACE REQUESTS OM 
THE QUEUE AND ONE TO REMOVE A REQUEST FROM 
THE QUEUE. 

(ASSUME THAT YOU ALREADY HAVE ACCESS TO THE 
QUEUE') 
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LINKING DEVICE DRIVERS TO THE I/O SYSTEM 


AFTER YOU HAVE WRITTEN YOUR DEVICE DRIVER CODE YOU 
MUST LINK IT TO THE I/O SYSTEM 

THE FOLLOWING COMMAND CAN BE USED TO ACCOMPLISH THIS*. 
LINK 86 

: Fo: ios. libCistart), & 

IFI.’ITABLE.OBT, &, 

:Fi:iDEVCF.OBT, & 

: FI. DRIVER, OBJ, & 

:FO'. IOOPT1.LIB, A 

: FO • IOS. LI&, & 

: Fo: RPlFC.LlB. 

To *. fi*. ros. lnk Clinker options) 
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COHFlCaVrM.,*, 


INTO THE X/O SYSTEM 


To CONFI6URE YOUR DEVICE DRIVERS INTO THE I/O 
SYSTEM YOU MUST ADD THE NECCESSARY DEVICE 
DRIVER INTERFACE STRUCTURES TO THE FILE IDEVCF 
• ^ q & 

this consists of adding duib's for each device 

UNIT AND THE REQUIRED COMMON AND UNIT INFO. 
BLOCKS AS NEEDED. 
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CHAPTER '* 


LXTENOED INPUT/OUTPUT SYSTEM 

(eios) 



VIEW Qua 


NAME 3 FILE TYPE* 
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TERMINOLOCtf 


• % USER • ACCESS RIGHTS 

• USER OBJECT • FILE CONNECTION 

• DEVICE 

• DEVICE CONNECTION 

• FILE 
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BASIC Vo SYSTEM 

INTERACTION SEQUENCE 

I. OBTAIN USER TOKEN Using a structure of user 
ID AND ALIASES 

USERTKN = RQCREATE USER C@ STRUCT, @ STATUS); 

/* TE5T STATUS */ 

X. OBTAIN DEVICE CONNECTION TOKEN USING THE 
PHYSICAL DEVICE NAME 

call rq a Physical attach pevice (dev name, file 
DRIVER, RESPNBXj @ STATUS); 

/# TEST STATUS TO CHECK SYNCHONOUS PORTION OF 
CALL-*/ 

TKN = RQRECIEVE MESSAGE (MBX, TIME, , <© status)} 
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BASIC Vb SYSTEM 

INTERACTION SEQUENCE 


A. Ccontinued) 

/* CHECK TOKEN RECIEVED. lFTYPE=|OlH YOU 
HAVE A CONNECTION. I F TYPE = 6, YOU HAVE 
A PROBLEM */ 

3 . obtain file connection usino the device connection 
Token, user token, and a file name subpath 

CALL RQ A ATTACH FILE (USER, DEVTKN, SU&PATH, } Q STATUS); 

/*TEST STATUS TO CHECK SYNCHRONOUS PORTION O F CALL-*/ 

TKN= RO REClEVE MESSAGE (mBXi,tiME, ,© status); 

/* CHECK TOKEN TYPE. IF TYPE IOI H YOU HAVE A FILE 
CONNECTION. IF TY PE = fo YOU HAVE A PROBLEM*/ 



BASIC ‘/o SVSTEM 

INTERACTION SEQUENCE 

4 . OPEN FILE FOR USAGE USING THE FILE CONNECTION 

AND THE MODE AND SHARING METHOD 

CALL RQA OPEN (CONN, MODE, SHARING, RESPM BY, @ status) 

/# TEST STATUS TO CHECK SYNCHRONOUS PORTION OF CALL*/ 

MSGTKN = RQ RELIEVE MESSAGE (RESPMBX, TIME, , 
STATUS) ; 

/# TEST STATUS FIELD OF XORS RETURNED TO CHECK 
ASYNCHONOUS PORTION OF CALL.*/ 


/# FINALLY You CAN Read oR write!! -#/ 



diversion* the connection 

BfcSlC r /o STYLE 


TO ACCESS A File we nust have a connection to it 

WE GENERALLY OBTAIN THIS CONNECTION IN TWO STEPS 
I. OBTAIN DEVICE CONNECTION USING'. 

RQ A physical attach device 
Pass device name 
RE Cl EVE TOKEN 



diversion: the connection 

BASIC Vo STYLE 


2. OBTAIN FILE connection using 

RQA ATTACH FILE 

PASS PREFIX CuSuALLY THE DEVICE token) 

AND subpath 

RELIEVE FILE CONNECTION TOKEN 


YOU NOW USE THE FILE CONNECTION TOKEN FOR 
ALL EITHER INTERACTION WITH THE FILE. 



AN EXAMPLE. 


ROOT 
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EXAMPLE CONTINUED 


LETS SAY THE DEVICE HAS BEEN ATTACHED TO AND WE HAVE ITS 
TOKEN. 

possibilities: 

PREFIX SUB PATH 

TO GET TO JILL’. TOKEN + A/e/JILL 

OR. 

STEP X TOKEN + A - NEW TOKEN 

STEP X NEW TOKEN + E/jILL 

(TRY SOME OTHERS !) 


7-/o 



EIOS TERMINOLOGY 


IN ADDITION TO THE BASIC V© SYSTEM TERMINOLOGY 
WE ADD*. 


• LOOalCAL NAMES 

• x /o JOBS 

• DEFAULT PREFIX AND PATH PTR 
PARAMETERS 



THE. LOGICAL DEVICE NAME 


definition: 


EXAMPLES*. 


A NAME ATTACHED TO A PHYSICAL DEVICE 
AT CONFIGURATION OR RUN TIME WHICH 
HAS MORE MEANING TO THE USER. 


PHYSICAL 

LOGICAL 

F0 

:F0: 

FX1 

: hd floppy: 

WDl 

: WINNY: 

F0 

: SYSTEM*. 

FI 

.patient: 



TWO WAT$ TO CREATE A LOCal CM DEVICE- NAME 


ONE 


* USE RQA PHYSICAL ATTACH DEVICE 

PASS PHYSICAL DEVICE NAME 
RELIEVE TOKEN 


• CATALOG THE TOKEN USING RQ A CATALOG 

Connection 

PASS TOKEN, LOGICAL NAME, JOB 

(WITH THIS METHOD YOU CAN CATALOG THE CONNECTION IN 
ANY JOBS DIRECTORY) 



TWO WAYS TO CREATE A LOGICAL DEVICE NAME 


TWO 


, USE RQA LOGICAL ATTACH DEVICE 

PASS LOGICAL NAME, DEVICE NAME 

(LOCalCAL DEVICE OBJECT IS CATALOCiED IN THE ROOT 
JOB UNDER THE LOGICAL NAME) 

C NOTE*. THE LOGICAL DEVICE OBJECT IS NOT A CONNECTION. 
THE EIOS WILU CREATE A DEVICE CONNECTION 
DURING THE FIRST EIOS CALC THAT OSES THE 
LOGICAL NAME) 



THE LOGICAL FILE NAME 


definition: 


EXAMPLES'. 


A NAME ATTACHED TO A FILE CONNECTION 
AT RUNTIME FOR USE OF USE.R . 



CMORE ON THIS IN A MINUTE \) 


aXJS 



THE Vo JOB 

TO USE. EXOS CALLS YOUR TASK MUST BE RUNNING IN AN 
Vo JOB. 


definition*, an x /o job is an rmx-86 job with three 

EXTRA ATTRIBUTES. 

1. A CATALOG ENTRY IN ITS OWN DIRECTORY 

UNDER THE NAME "RQ GLOBAL*' (JOB TOKEN) 
A. A CATALOG ENTRY OF ACONNECT ION UNDER 
THE NAME "4>“ . (DEFAULT PREFIX) 

3. A CATALOG ENTRY OF A USER TOKEN UNDER 
THE NAME R? USER, (default USER") 



TO CREATE AN r /o TOB 


CREATE AT SYSTEM CONFIGURATION USING THE EIOS MACRO. 
USE THE CREATE Vo JOE SYSTEM CALC DURING RUNTIME. 

PROBLEM: this CALL can ONLY BE MADE FROM A 

task running in an Vo TOB. 



LOGICAL NAMES AND PATH* 



DEFAULT PREFIX 


•PURPOSE: 


• example: 


REDUCE PROGRAMMER EFFORT AND ERRORS BY 
ALLOWING REFERENCE TO A DE FAULT CONNEC- 
TION (to afile or device) which is cataloged 

IN THE Vo XOB DIRECTORY. 

A particular V° Job must frequently 

ACCESS A DATA FILE. OBTAIN THE CONNECTION 

For the file and catalog it in the x /o 

7oB DIRECTORY UNDER AFTER THIS IS 

DONE ANY attach FILE A CALL With a null 
PATH WILL AUTOMATICALLY ATTACH TO THE DATA 
FILE. 
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CREATING A LOGICAL FILENAME 


1. ATTACH TO A DEVICE 

Z. RELIEVE TOKEN! (opt to nal\ catalog as a logical device) 

3 . ATTACH TO THE DESIRED FILE 

rqs attach file 

PASS PATHNAME STRING 
RELIEVE CONNECTION 

4. CATALOG THE CONNECTION 

RQS CATALOG CONNECTION 

PASS CONNECTION, JOB, LOGICAL NAME 



PATH NAME STRING 

4 , COUNT' EM, 4 FLAVORS! 


STRING PASSED 

NULL 

Logical name only 

Sub PATH ONLY 

LOGICAL NAME + SUB PATH 



EIOS ACTION 

USE DEFAULT PREFIX 
USE PATH CATALOGED 
DEFAULT PREFIX + SUBPATH 
USE PATH CATALOGED TO 
GET TO DIRECTORY THEN 
FOLLOW SUBPATH FROW THERE 
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PAT H NAME STRINGS 

(.examples) 


NULL 


LOGICAL NAME 
ONLY 


ASSUME DEFAULT PREFIX IS*. 

f^/a/b 

PASS NULL FOR ATTACH FILE AND GET 
CONNECTION TO F0/a/B 

ASSUME ’.DATABASE: IS THE LO fa I CAL 
NAME FOR’. 

Wdx/tue / second/ data 

PASS THE LOGICAL STRING : DATA BASE '• 
CiET CONNECTION TO DATA FILE 



PATH NAME STRINGS 

(.examples) 

•SUBPATH ONLY ASSUME DEFAULT PREFIX .' 

POINTS TO (DEVICE NAME) 

PASS SUB PATH Q/l^p/ FILE X 


•LOGICAL NAME 
■+* 

Subpath 


ASSUME LOGICAL NAME. .'PATIENT'. 

Points to pgf /i9->9/patient 


pass subpath : patient: tack/ strange 

RELIEVE CONNECTION TO: 

F<fi/\919 j PATIENT / TACK /STRANGE 
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THE DEFAULT USER 


TO ATTACH TO A FILE YOU NEED 

• PATH STRING 

• USER ID 
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THE. DEFAULT USER 


THE EXTENDED T /o SYSTEM* ATTACH CALL- HAS ONLY 
X PARAMETERS, PATH PTR AND STATVS 

HOW DOES THE USER ID 6ET PASSED? 
SIMPLE, THE ElOS USES THE DEFAULT USER ID OF 
THE JOB C jo or COURSE) THAT CONTAINS THE 
CALLING TASK. 1 



ElOS INTERACTION SEQUENCE 


I. attach to a den/icc usinctA logical name. 
Physical name and file driver desired 


CALL RQ LOGICAL ATTACH DEVICE (& (.9, PATIENT:') 

e(x, ’F0'), 4, 

& status); 

FV IS IN THE SYSTEM DUiB's 


A. Attach to the file specifying the path name 

CONKITKN = RQS ATTACH FILE (& ( 12, 'JONES/ ROBERT') 

e. status); 



EIOS INTERACTION SEQUENCE 


3. OPEN THE FILE SPECIFYING THE MODE AND NUMBER OF 
BUFFERS DESIRED 
CALL RQS OPEN(CoNNTKN, 3,X); 



E01$ CALLS OVERVIEW 


RELATING TO LOGICAL NAMES 

• RQS CATALOG CONNECTION 

• RQS LOOKUP CONNECTION 

• RQS UNCATALOG CONNECTION 


CREATE FILE OR CONNECTION 

• RQS ATTACHE FILE 

• RQS CREATE DIRECTORY 

• RQS CREATE FILE 



EOIS CALLS OVERVIEW 


DATA MANIPULATION 

• RQS OPEN 

• RQS CLOSE 

• RQS READMOVE 

• RQS SEEK 

• RQS WRITE MOVE 

• RQS TRUNCATE FILE 


DEVICE RELATED CALL 

• RQS SPECIAL 



EOIS CALLS OVERVIEW 


changing access, Renaming, obtaining statu* 

• RQS CHANGE ACCESS 

• RQS RENAME FILE 

• RQS GET connection status 

• RQS GET FILE STATUS 


DELETING FILETS AND CONNECTIONS 

• RQS DELETE CONNECTION 

• RQS DELETE FILE 



EOIS CONFIGURATION 


SELECT THE EOIS CAU-S TO BE INCLUOED IN THE 

final system 


SELECT THE LOGICAL DEVICES TO BE INITIALIZED 
IN THE FINAL SYSTEM 


CREATE THE INITIAL joB(s) IN THE SYSTEM 



EOIS CONFIGURATION 


FILE* PURPOSE 

ETABLE.A86 SYSTEM CALLS 

EDEVCF . A86 LOGICAL DEVICES 

EJOBCF.A&6 7o JOB 
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ETABIE A86 





ETABLE A86 

NAME 

$INCLUDE (:F2: ETABLE. MAC) 


JOB INTERFACE 

%RQCRE£TEIOJGB 
%RQEXITIO JOB 

CONFIGURATION INTERFACE 

%RQLOGICALATTACHDEVICE 

%RQLOGICALDETACHDEVICE 

SYNCHRONOUS INTERFACE 

%RQSCREATEFILE 

%RQSATTACHFILE 

%RQSDELETECONNECTION 

%RQSLOOKUPCONNECTION 

%RQSCATALOGCONNECTION 

%RQSUNCATALOGCONNECTION 

%RQSCREATEDI RECTORY 

%RQSDELETEFILE 

%RQSRENAMEFILE 

%RCSCHANGEACCESS 

%RQSOPEN 

%RQSCLCSE 

%RQSREADMOVE 

%RQSWRI TEMOVE 

%RQSSEEK 

%RQSTRUNCATEFILE 

%RQSGETFILESTATUS 

%RQSGETCONNECTIONSTATUS 

%RQSSFECIAL 

END 
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EDEVCF.&8fc 





NAME 


E.DEVCF . A86 


CGROUP 


$ INCLUDE ( : F 2 : EDEVCF . MAC ) 


t 

t 

i 


BYTE-BUCKET 

%DEV_INFO_BLOCK( ' BB ' , 'BB' , PHYSICAL) 
TERMINAL 

%DEV_INFO_ELOCK( 'T0 1 r *T0 ' , PHYSICAL) 
SHUGART 204, UNIT 0, DRIVE 0 

%DEV_INFO_BLOCK ( *F0' , 'F0 ' , NAMED) 

SHUGART 204, UNIT 1, DRIVE 1 

%DEV_INFO_B LOCK ( 'Fl ' , 'Fl ' , NAMED) 

218 WINCHESTER FLOPPY SS/SD, UNIT 0, DRIVE 0 
%DEV_INFO_BLOCK ( 'WF0 ' , 'WF0 ' , NAMED) 

218 WINCHESTER FLOPPY SS/SD, UNIT 1, DRIVE 1 
%DEV_INFC_BLOCK( 'WFl 1 , 'WFl ' , NAMED) 

STREAM 

%DEV__INFO__BLOCK ( 'STREAM ' , 'STREAM' , STREAM) 
%END DEV CONFIG (1024) 


END 
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EJ 06 C.F . A86 





EJOBCF . A86 


NAME 

CGROUP 

$ INCLUDE ( s F 2 : EJOBCF. MAC) 

; USER 'WORLD' DEFINITION 

%IO_USER ( 'WORLD ' , 0FFFFH) 

; EIOS TEST JOB 

%IO__JOB ( ' T0 ' , 'WORLD', 260H, 0FFFFH, 0:0, 0, 0, 155, 1800: 0, 1A00, 0:0, 1200, 0) 
%END__IO_JOB_CONFIG (40) 

END 


Note: the configured io_ job in the release file 

IS FOR THE HUMAN INTERFACE. 
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ASSEMBLING, UNKING AND LOCAT I N 6 THE ElOS 

(this is tough, so pay attention ).Q 


SUBMIT -fx* EIOS(dATE, LOC ADR) 


BEFORE DOING THIS SUBMIT YOU SHOULD PRINT 
THE FILE ON A TERMINAL OR A HARD COPYTO 
INSURE THAT THE FILE V/ILL NOT CALL FOR 
RESOURCES THAT YOU DO NOT HAVE. 



ADDING* THE ElOS TO THE SYSTEM 


• ONE JOB MACRO REQUIRED AT SYSTEM 

configuration TIME. 

• PARAMETERS FOR MACRO ARE FOUND 
IN THE LRMX-86 CONFIGURATIONS GUIDE 



CHAPTER QtMmJ 


1. GIVE A PHYSICAL DEVICE NAME. 

GilVE A LOGICAL DEVICE NAME. 

3. WHAT ARE THE CHARACTERISTICS OF AN I/O JOB? 


4-. WHAT IS THE ’‘OOTCHA*’ IN THE CREATION OF 
AN I/O TOB ? 
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CHAPTER QVi: 


5. WHAT IS A.. . 

A. DEFAULT USER 

B. DEFAULT PREF 


6. MATCfl THE FOLLOWING 

A. ETABLE. A0G 

B. E70&C.F. A8fe 

C. EDEVCF. A8fc 


CcOMT.') 


LOGICAL DEVICES 

SYSTEM CALL SELECTION 

10 706 CREATIOlM 




THE 

HUMAN 

INTERFACE 



OVERVIEW 


THE HUMAN INTERFACE is A LAYER OF 

THE RMX-86 SYSTEM THAT ALLOWS THE 
OPERATOR TO LOAD, EXECUTE AND 
SUBSEQUENTLY INTERACT WITH PR00.RAN 
FILES. 



RMX-86 AND 
THE HUNAN INTERFACE 



M 



RESIDENT/ NON-RESIDENT PROGRAMS 


RESIDENT: 


Non-resident: 


PROGRAMS LOADED AT SYSTEM RESET 
WHICH REMAIN IN MAIN MEMORY. 
Ccould BE IN ROM) 


PROGRAMS WHICH ARE LOADED INTO 
MAIN MEMORY FROM SECONDARY STORAGE 
UPON PROGRAM OR OPERATOR COMMAND 



SOME EXAMPLES 


system /resident: APPLICATION LOADER, 

EXTENDED T /o SYSTEM 

SYSTEM /NON-RESIDENT*. COPY, DIR, DELETE 

USER/ resident: data collection, interrupt 

driven tasks. 

user/non-Resioent: DATA REDUCTION, data 

ANALYSIS PROGRAM. 



HUMAN INTERFACE 
SERVICE? 


• NON - RESIDENT COMMANDS 


• RESIDENT SYSTEM SERVICES 



NON-RESIDENT COMM AN OS 


FILE MANIPULATION 

• ATTACH DEVICE 

• CREATE DIR 

• DETACH DEVICE 

• DOWN COPY 

• RENAME 


general utility 


♦ DATE 

• SUBMIT 


• Copy 

• DELETE 

• DIR 

• FORMAT 

• UPCOPY 


• DEBUC* 

• TIME 



HUMAN INTERFACE 

COMMAND SYNTAX 

COMMAND INPATHLIST [PREPOSITION OUTPATHLiST] (PARAMETERS') 

WHERE: INPATHLIST = ONE OR MORE FILES TO BE USED AS 

INPUT DURING COMMAND EXECUTION 
PREPOSITION = HOW YOU WANT OUTPUT HANDLED 

outpathlist =one or more files to relieve 

OUTPUT DURING COMMAND EXECUTION 
PARAMETERS = REQUESTED OPTIONAL SERVICES 



PATH LISTS 


PATHNAME [ .PATHNAME] . . . 

examples: 

my File/data 

YOUR FILE/ 1979/DATA, JACK FI LE/sAMP 1 

a/b. a/c, a/d, E/q/e 



PREPOSITIONS 


TO -OUT PUT TO NEW FILE: 

C IF OLD FILE IS SPECIFIED, AQUERY RESULTS) 

OVER -OUTPUT TO OLD FILE OVER OLD DATA 
CW WETHER OR NOT TARGET FILE EXISTS) 

AFTER- OUTPUT APPENDED AFTER DATA IN TARGET FILE 

CwHETHER OR NOT TARGET FILE EXISTS) 

AS- ASSOCIATES A PHYSICAL DEVICE TO A LOG ItAL 
NAME (only for the Attach device command) 



CONTROL CHARACTERS 


CHARACTER MEANING 


tz 

tc 
f D 

to 

ts 

tQ 

fX 

tR 


END OF FILE 
PROGRAM ABORT 
INVOKE DEBUGGER 

supress/restore output 

SUSPEND OUTPUT 
RESUME OUTPUT 
DELETE CURRENT INPUT LINE 
REPEAT CURRENT LINE OR 
PREVIOUS LINE IF CURRENT 
LINE IS EMPTY 
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COPY 


COPY DATA FRON INPUT FILEOb) To OUTPUT FlLtfc) 





DATE 


SET OR display current date 




DIR 

LIVT TWE NAMES AND ATTRIBUTES OF FILES IN A SELECTED 
DIRECTORY. 
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FORMAT 

FORMAT OR REFORMAT A VOLUME ON A SECONDARY 
STORAGE DEVICE (DISK, DISKETTE, BUBBLE) 
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RESIDENT SYSTEM SERVICES 


r /0 PROCESS 1NG CALLS 
COMMAND parsing calls 

MESSAGE PROCESSING CALLS 
COMMAND PROCESSING CALLS 
PROGRAM CONTROL. CALL 



r /o PROCESSING CMLS 


C G»ET INPUT CONNECTION 

PASS INPUT PATHNAME 
RETURN EIOS CONNECTION 


COE.T OUTPUT CONNECTION 

PASS OUTPUT PATHNAME 
RETURN EIOS CONNECTION 



COMMAND PARSING CALLS 

• CCaET INPUT PATHNAME 

RETURN PATHNAME FOR STANDARD INTO FILE 


• CCaET OUTPUT PATHNAME 

RETURN PREPOSITION AND PATHNAME FOR 
STANDARD OUTPUT FILE 


• CCaET PARAMETER 

RETURN NEXT PARAMETER FROM INPUT LINE 
AS KEYWORD NAME AND VALUE 


6 m /6 



COMMAND PARSING CALLS 
• C SET PARSE BUFFER 

switch to new buffer 


6r/9 



MESSAGE PROCESSING CALLS 


C FORMAT EXCEPTION 

PASS EXCEPTION CODE 

RETURN MESSAGE IN USER BUFFER 

C SEND CO RESPONSE 

SEND MESSAGE TO COMMAND OUTPUT 

Read response from command input 

C SEND EO RESPONSE 

SEND MESSAGE TO ERROR OUTPUT 
READ RESPONSE FROM ERROR INPUT 



COMMAND PROCESSING CALLS 


c create: command conn ection 

RETURN COMMAND CONNECTION TOKEN 

C DELETE COMMAND CONNECTION 

PASS COMMAND CONNECTION TOKEN 

delete connection 

CSEND COMMAND 

RECIEVE COMMAND LINES FROM CONSOLE 
SEND TO COMMAND DATA SPACE AND EXECUTE 



PROGRAM CONTROL CALL 


C SET CONTROL C 

SEND NEW CONTROL-C SEMAPHORE TOKEN 



HOW DOES AU.OF THIS WORK? 

PHASE 1. COMMAND LINE INTERPRETER PARSES 

THE COMMAND LINE TO BREAK OUTTHE 
PATHNAME TO THE PROGRAM FILE. 

JACK/ PROG 1 [£> I PROG JACK/PROG 1 (first) 

O R : SYSTEM: JAtK/PROfcl(sEC0NC>) 
: F9*. jack/prog 1C^> : F9 : jack/progi (only') 
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HOW DOES All OE THIS WORK? 


PHASE X. PROGRAM EMPLOYS HI COMMANDS TO 

CARRY OUT ITS OWN PROCESSING. 


EXAMPLE: PROGRAM TO ENCODE ADATAFILE 

6ET IN PUT PATHNAME 
0»ET OUTPUT PATHNAME 

<aET INPUT CONNECTION 
<a£T OUTPUT CONNECTION 

PROCESS FILE 

DELETE INPUT CONNECTION 
DELETE OUTPUT CONNECTION 

EXIT VO TOB 



CREATING ANEW CUUP 

(commonly used user program) 

1 WRITE THE PROGRAM 

X. ASSEMBLE OR COMPILE THE PROGRAM 

3. LINK CODE TO APPROPRIATE RHX-86 LIBRARIES 
USE BIND, NOINIT CODE AND MEMPOOL DIRECTIVES 
TO CREATE LTLORPIC MODULE CSERlES in'] 


-OR- 
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CREATING ANEW CUUP 


USE LINK AND LOCATE WITH NOINIT CODE AND 
MEMPOOL DIRECTIVES TO CREATE an absolute 
MODULE. (THERE MUST 6E RESERVED SPACE IN 
WHICH TO LOAD IT. 1 ) (SERIES Dl} 

-OR- 

USE LINK AND LOCATE ON A SERIES II TO 
CREATE AN ABSOLUTE MODULE (ONLV) 



CREATIN6 A NEW 6 UUP 


PUCE PROGRAM IN AN APPROPRIATELY NAMED 
FILE IN EITHER THE : SYSTEM'. DIRECTORY OR 

the ;Proo»: directory 



THE COMMAND CONNECTION 

OR 

THE ULTIMATE SUBROUTINE: 

PROBLEM: I HAVE A PROGRAM WHICH WILL- 

COPY, process, sort and further 

PROCESS A FILE OF DATA, I HAVE 
A SYSTEM COPY AND SORT ALREADY 
AND WOULD LIKE TO USE THEM LIKE*. 



end 



THE COMMAND CONNECTION 


A BOND BETWEEN YOUR PROGRAM AND THE 
COMMAND LINE EXECUTOR . 

USED WHEN YOUR PROGRAM WANTS TO SEND A 
COMMAND LINE TO BE EXECUTED. 

CAN BE ESTABLISHED ONCE AT PROGRAM START 
AND USED THROUGHOUT THE PROGRAM RUN 



SEND COMMAND 


A SYSTEM PROGRAM TO MOVE A BUFFER OF DATA 
(aconmand) to the command connectio n. 


IF BUFFER CONTAINS A CONFIGURATION 0HARAC7OR 
SEND COMMAND RETURNS IMMEDIATELY OTHERWISE 
IT RETURNS AFTER COMMAND IS EXECUTE D. 



AN EXAMPLE 


OUR SORT PROGRAM. 

PROGRAM IHVOCATION- 

FAST SORT :Fll JACK/ DATA TO 

J \ 

USER COMMAND INPUT FILE 


:F>: TACK/SORTEP 

; 

OUTPUT FILE 
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AN EXAMPLE 


GET INPUT PATHNAME INTO A PRIVATE BUFFER 

GET OUTPUT PATHNAME INTO A PRIVATE BUFFER 

3 • CREATE COMMAND CONNECTION 

*-• FORMAT COPY COMMAND IN PRIVATE COMMAND 
BUFFER USING INPUT AND OUTPUT PATHNAMES 

SEND ASSEMBLED COMMAND To COMMAND 
CONNECTION 

copy program runs 
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AN EXAMPLE 


6. PROCESS COPIED DATA 

**• FORMAT SORT COMMAND IN PRIVATE COMMAND 
BUFFER AGAIN USING INPUT AND OUTPUT PATHNAMES 

8* SEND ASSEMBLED COMMAND TO THE COMMAND CONNECTION 

SORT PROGRAM RUNS 

9* DELETE COMMAND CONNECTION 


Jl 


FINISH PROCESSING AND EXIT 



ANOTHER USE 


SINCE. THE PRIVATE COMMAND BUFFER COULD BE FILLED 
FROM ANY SOURCE., IMAGINE. . . 

1. READ A FILE INTO COMMAND BUFFER 
Z. SEND COMMAND 

3. REPEAT FOREGOING AS LONG AS "DATA* 
EXISTS IN THE FILE. 

WHAT DOES THIS REMIND YOU OF? 



HUMAN INTERFACE CONFIGURATION 


DESIGNATE PATHNAMES FOR THE LOGICAL NAMES 
REQUIRED BY THE HUMAN INTERFACE 

SPECIFY THE SIGN ON MESSAGE 

SPECIFY THE MAXIMUM COMMAND NAME LENTGH 


SPECIFY THE DIRECTORIES AND THE SEQUENCE 
THAT THE human interface WILL SEARCH THEM 
IN FOR USER PROGRAMS 



PATHNAME - LOGICAL NAME, 
SPECIFICATION 


• FOUR DIRECTORIES - SYSTEM 

PROG 

DEFAULT 

WORK 

• LOGICAL DEVICE NAME (: F0: in supplied file) 

MUST BE CONFIGURED IN THE EXTENDED Yo SYSTEM 
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THE SIGN ON MESSAGE 


MAXIMUM LENGTH IS XS5 CHARACTERS 
ESSENTIALLY "ANYTHING GOES 1 ." 



(within the bounds of good taste, ofcouRse) 


SOME EXAMPLES 

"jACLYN SYSTEM *000 V|.o" 

* WORDCRUSHER V*.9 JOEN MFG» COPYRIGHT 19B7 



COMMAND NAME LEN6TH 


THEORETICALLY COUID BE X ‘ b -l 


HOWEVER, A5IN6LE LINE C&o) MAKES 
A BIT MORE SENSE. 



DIRECTORIES AND SEARCH SEQUENCE 


• A MAXIMUM OF X55 DIRECTORIES CAN BE AUTOMATICALLY 
SEARCHED 

• USER SUPPLIES A STRIN6 TABLE OF NAMES 

• SYSTEM SEARCHES DIRECTORIES IN SEQUENCE GIVEN. 

• IN ALL CASES THESE DIRECTORIES MUST BE CONFIGURED 
IN THE EXTENDED r /o SYSTEM (MUST EXIST BEFORE THE 
HUMAN INTERFACE 8EGINS RUNNING) 
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LINKING AND LOCATING THE 
HUMAN INTERFACE 

(ANOTHER BI6 ONE*) 


SUBMIT 


WHERE 


:fx: H | (DATE , LO c) 


DATE = MM/dd/YY or 
DD MMM YY 

LOC - LOCATION OF HUMAN 

INTERFACE WHEN SYSTEM 
IS LOADED. 



HUMAN INTERFACE PREREQVMStTS 


NUCLEUS 

DEBUGGER OR TERMINAL HANDLER 
BASIC x /o SYSTEM 
EXTENDED Vo SYSTEM 

APPLICATION LOADER 

IN ALL CASES ABOVE THE CALLS REQVlRSO 
BY THE HUMAN INTERFACE MUST ©E- 
CONFIGURED. 



terminal handler 

REQUIREMENTS 





TERMINAL HANDLER 
REQUIREMENTS 


IF YOU WANT TO USE tC MODULE. FROM HUMAN 
INTERFACE FOR PROGRAM CONTROL CAB0R7) 


MODIFY MTHCSD or 

D&.CSD 


ADD 


:fx: hi.lib(hcontc), ^ 



BASIC Vo SYSTEM 
REQUIREMENTS 


FILE DRIVERS 


DUIBS - 


PHYSICAL 

STREAM 

NAMED 

T <f> (terminal DEVICE) 

BB (BYTE BUCKET) 
STREAM (STREAM FILE DEVICE) 
? ( AHV DISK OR BUBBLE 

DEVICES REQUIRED) 


DEVICE DRIVERS FOR ALL DUIBS 



EXTENDED % SYSTEM 
REQUIREMENTS 


• CONFIGURATION FILE (EDEVCF.AB&) MUST INCLUDE*. 

T0 

BB 

STREAM 

• Vo JOB FlLE(EJOBCF. A8fc) MUST INCLUDE AN Vo JOB 
MACRO FOR THE MU MAN INTERFACE 

• MEMORY 1 POOL FOR EIOS MUST BE LARGE ENOUGH TO 
INCLUDE THE HUMAN INTERFACE 
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CHAPTER 


1 . WHAT 15 AN EXAMPLE. OF A NON-RLSIPENT USER 
PROGRAM ? 


X. GIVE X NON-RESIDENT USER COMMANOS 


3. WHAT IS THE EFFECT OF THE AFTER PREPOSITION? 


4-. WHAT IS THE DIFFERENCE BETWEEN 4*0 AND 

TS? 
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CHAPTER QUIZ f 


5. WHAT X CALLS CAN BE USED TO 6»ET AN INPUT 
CONNECTION FROM THE COMMAND LINE? 



7. WHAT IS THE FILE FOR HOMAN INTERFACE 
CONFIGURATION? 
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INTEL WORKSHOPS 


Introductory Workshops 

Introduction to Microcomputers (4 days) 

Intellec Development Systems (3 days) 

Operating Systems Fundamentals (2 days) 

6060. 6065 System Design Workshops 
MCS-80/85 System Design (5 days) 

PASCAL Programming (5 days) 

PL/M Programming (5 days) 

iRMX 88.80 Operating Systems (5 days) 

6066. 6066 System Design Workshops 
iAPX 86.88 System Design (5 days) 

iAPX 86.88 Advanced Assembly Language (5 days) 
ICE 86.88 and iAPX 86/2 1 ( 5 days) 
iAPX 286 Architecture (3 days) 

PASCAL Programming (5 days) 

PL/M Programming (5 days) 
iRMX 88,80 Operating System (5 days) 
iRMX 86 Operating System (5 days) 
iRMX 86 I/O Operating System (5 days) 

432 Workshops 

iAPX 432 Architecture (3 days) 

Ada Programming (4 days) 

Programming Language Workshops 
PASCAL Programming (5 days) 

PL/M Programming (5 days) 

iAPX 86,88 Advanced Assembly Language (5 days) 

Ada Programming (4 days) 

Single Chip Microcomputer Workshops 
MCS 48/49 System Design (5 days) 

MCS-51 Microcontroller (5 days) 

2920 Signal Processor (5 days) 

Peripheral Chips Design Workshops 
Data Communication Chips (4 days) 

IEEE-488 GPIB Chips (3 days) 

Bubble Memory Design (3 days) 


Western Region/San Francisco Area 
1350 Bordeaux Dr. 
Sunnyvale, CA 94086 
408-734-8102 


Mid-America Region/Chicago Area 
2550 Golf Road/Suite 815 
Gould Center 

Rolling Meadows, IL 60008 
312-981-7250 


Eastern Region/Boston Area 
27 Industrial Ave. 
Chelmsford, MA 01824 
617-256-1374 




INTEL CORPORATION. 3065 Bowers Avenue, Santa Clara. CA 95061 (408) 987 8080 



